home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / graphics / psfig / README < prev   
Text File  |  1993-11-10  |  3KB  |  89 lines
  1. psfig/tex -- TeX macros for the inclusion of postscript figures
  2.  
  3. ==================================================================
  4.  
  5. COPYRIGHT NOTICE
  6.  
  7. All software, documentation, and related files in this distribution of
  8. psfig/tex are Copyright 1993 Trevor J. Darrell
  9.  
  10. Permission is granted for use and non-profit distribution of psfig/tex 
  11. providing that this notice be clearly maintained, but the right to
  12. distribute any portion of psfig/tex for profit or as part of any commercial
  13. product is specifically reserved for the author.
  14.  
  15. Thanks to Ned Batchelder, Greg Hager, J. Daniel Smith, Tom Rokicki,
  16. Robert Russell, George V. Reilly, Ken McGlothlen, Dr. Baron Grey,
  17. Gerhard Tobermann and all others who have contributed code and
  18. comments to this project!
  19.  
  20. ==================================================================
  21.  
  22. NEW IN VERSION 1.10
  23.  
  24. - Support for OzTeX (derived from Baron Grey's OzTeX version of psfig)
  25.  
  26. - New searching path algorithm (from Gerhard Tobermann); looks in
  27.   multiple directories; looks for file.ps before file.ps.bb...
  28.  
  29. - Many small bug fixes (underscore in draft mode, angle/clip interaction)
  30.  
  31. - Improved documentation and man page
  32.  
  33. ==================================================================
  34.  
  35. SYSTEM REQUIREMENTS
  36.  
  37. Psfig/tex uses \special calls to manipulate the PostScript environment
  38. within a document, and include figure files. To use psfig, you must
  39. therefore be using a postscript device for your output. This version
  40. of psfig/tex works with the unix "dvips" PostScript driver, which is
  41. available from labrea.stanford.edu, and with OzTeX.  
  42.  
  43. It may also work with the ArborText "dvips" driver, and with the
  44. "dvi2ps" written by Tony Li <tli@sargar.usc.edy>; see the
  45. "unsupported" directory.
  46.  
  47. ==================================================================
  48.  
  49. INSTALLATION
  50.  
  51. To install psfig, simply copy psfig.sty into a directory on your TeX
  52. include path (e.g. /usr/lib/tex/macros).
  53.  
  54. If you are using OzTeX, change the driver line at the top of
  55. the psfig.sty file to read
  56.     \def\setDriver{\OzTeXDriver} 
  57. instead of 
  58.     \def\setDriver{\DvipsDriver} 
  59.  
  60.  
  61. A users guide and manual page can be found in the "doc" directory.
  62.  
  63. For tips on dealing with Macintosh postscript, see the directory
  64. "unsupported/macdemo/README".
  65.  
  66. ==================================================================
  67.  
  68. BUGS
  69.  
  70. If you use the letter style, make sure you include the psfig style
  71. first.
  72.  
  73. If you have an old version of dvips, you may need to make a patch to
  74. use the compressed figure option, and to handle magnification
  75. correctly.  The files "unsupported/dospecial.[patch,frag]" contain a
  76. patch and a corresponding code fragment for dvips' dospecial.c file.
  77. To apply the patch copy dospecial.patch into your dvips directory and
  78. run "patch < dospecial.patch", and then recompile. "dospcial.frag"
  79. contains the modified portion of the code as it should appear in the
  80. patched file.  To use magnification with psfig and dvips, you need to
  81. change the line
  82.     /magscale false def
  83. in special.pro to 
  84.     /magscale true def
  85. in order to have the figures scaled correctly.
  86.  
  87.  
  88.  
  89.